home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr09 / grocr301.zip / GROCERY.DOC < prev    next >
Text File  |  1993-06-06  |  18KB  |  383 lines

  1.  
  2.  
  3.  
  4.  
  5.                              THE GROCERY SHOPPER
  6.                                   Ver. 3.01
  7.                           A Product of Clark Systems
  8.                                 Copyright 1991     
  9.  
  10.          Welcome to The GROCERY SHOPPER, an unpretentious little program
  11.     whose sole purpose in life is to make your grocery shopping chores a
  12.     little easier, more organized and more fun (at least in the planning
  13.     stages). It won't keep you from having to go to the store, but it might
  14.     help you get in and out a little quicker.
  15.  
  16.          We hope that you find the GROCERY SHOPPER useful and encourage 
  17.     your comments and suggestions, even if you decide not to register and 
  18.     not to continue use of The GROCERY SHOPPER. Please feel free to 
  19.     contact us at the address given in the SHAREWARE and REGISTRATION 
  20.     section.
  21.     _______________________________________________________________________
  22.  
  23.                                    SUMMARY
  24.  
  25.          The GROCERY SHOPPER assumes two things. (1) That you normally 
  26.     shop for your groceries at the same store, and (2) that you would 
  27.     prefer to speed up your shopping trip by getting all grocery items in 
  28.     one pass up one Aisle and down the next. The GROCERY SHOPPER helps you 
  29.     accomplish this by making it simple to develop a shopping list of 
  30.     items you normally buy, then printing the list out with the items 
  31.     organized by aisle.
  32.  
  33.          The GROCERY SHOPPER maintains a inventory, or database if you 
  34.     will, of grocery items available in your regular grocery store, which 
  35.     you create initially, then add to and maintain as long as you use the 
  36.     program. The minimum information you must maintain in the ITEMS 
  37.     database is the description of the grocery item itself and the AISLE 
  38.     in which it is located, but you may add considerably more detail, up 
  39.     to and including the COST PER each item (which will give you a very 
  40.     detailed shopping list, indeed). Every time you need something new you 
  41.     simply and quickly add it to the database of shopping items where it 
  42.     is thereafter available to you for future use on a future list.
  43.  
  44.          Since the GROCERY SHOPPER includes extensive on-line help, there 
  45.     won't be a lot of detail to be found in this documentation except for 
  46.     generalized information about program objectives, operation and 
  47.     navigational controls.
  48.  
  49.  
  50.                                   DISCLAIMER
  51.  
  52.          Clark Systems and its agents make no claim of any kind, express 
  53.     or implied, including without limitation, any warranties of 
  54.     merchantability and/or fitness for a particular purpose. Clark Systems 
  55.     and its' agents shall not be liable for any damages, whether direct or 
  56.     indirect, special or consequential arising from a failure of this 
  57.     program.
  58.          
  59.          In no event shall Clark Systems or its' agents be liable to you 
  60.  
  61.  
  62.  
  63.     for any damages, including lost profits, lost savings or other 
  64.     incidental or consequential damages arising from use or inability to 
  65.     use this product or any claim by any other party.
  66.  
  67.  
  68.                           SHAREWARE and REGISTRATION
  69.  
  70.          GROCERY SHOPPER is Shareware, meaning that it is not free but 
  71.     is being made available to you on a trial basis. If you use The GROCERY
  72.     SHOPPER beyond a reasonable trial period you are requested to register
  73.     your copy with Clark Systems for the minimal fee of $15.00. In return
  74.     you will receive one free update as the next one becomes available,
  75.     access to low-cost future updates, information on other Clark Systems
  76.     database products and our eternal gratitude which, along with $.75 might
  77.     buy you a cup of coffee.
  78.  
  79.          To register your copy of The GROCERY SHOPPER send your check or 
  80.     money order along with your name, address and preferred diskette size 
  81.     to:
  82.                              The GROCERY SHOPPER
  83.                              Clark Systems
  84.                              129 Pitney Road     
  85.                              Absecon, N.J.  08201
  86.  
  87.          Clark Systems and the GROCERY SHOPPER are not associated in any 
  88.     way with any Shareware distributor, and any fee paid to any such 
  89.     distributor does not constitute registration of The GROCERY SHOPPER. 
  90.     Only payment made directly to Clark Systems constitutes registration 
  91.     as discussed above.
  92.  
  93.          The GROCERY SHOPPER may be copied and distributed so long as no 
  94.     fee is charged beyond minimal shipping and handling costs, and 
  95.     provided that all files listed below are included.
  96.  
  97.  
  98.                             FILES YOU SHOULD HAVE
  99.  
  100.                       Grocery.exe              Items.frm   
  101.                       Grocery.dbf              Items2.frm  
  102.                       Grocery.doc              Gro_scrn.com
  103.                       Help.dbf                 Readme.1st
  104.                       Help.dbt                 Reg_form.txt     
  105.                       File_id.diz
  106.                                                  
  107.                                                      
  108.                           WHAT'S NEW IN VERSION 3.01
  109.  
  110.          We've received a number of suggestions for improving the Grocery 
  111.     Shopper some of which we've included in this release. We'd like to 
  112.     thank all of our registered users for their warm comments and helpful 
  113.     suggestions.
  114.  
  115.        Item Cost
  116.  
  117.          You now have the option of entering a 'Cost Per' for each item in 
  118.  
  119.  
  120.  
  121.          the database. Doing so enables you to take advantage of a new 
  122.          printed list option which gives you a two column, standard type 
  123.          size shopping list with the total cost for each item placed on 
  124.          the list (quantity of the item entered times the cost per of each 
  125.          item), and a total cost of all items at the end.
  126.  
  127.        New Items Report
  128.  
  129.          In keeping with the addition of cost for each item, you may print 
  130.          out a report of all items in the grocery database with or without 
  131.          cost.
  132.  
  133.        Aisle Designations
  134.  
  135.          You have a much wider range of options to use for Aisle 
  136.          Designators. You can now enter numbers, letters, combinations of 
  137.          numbers and letters or words. So, for those of you with 'A' 
  138.          aisles or 'MEAT' aisles, you're in business. In this system, 
  139.          numbers come before letters.
  140.  
  141.          Incidentally, this corrects a program bug which would allow 
  142.          proper searching on certain numbers.
  143.  
  144.  
  145.  
  146.                                   BUG FIXES
  147.          
  148.          We hope we've corrected all the bugs in version 2.1. God only 
  149.     knows if we've missed any in version 3.01. Please let us know if you
  150.     come across any. The following known bugs have been fixed:
  151.  
  152.          - Cursor left turned off when exiting the program. Very poor 
  153.            behavior in a program.
  154.  
  155.          - Leaving the printer in condensed mode after running the 4 
  156.            column condensed report/list. Also very poor program 
  157.            behavior.
  158.  
  159.          - Inability to search properly on certain numbers, especially 
  160.            those numbers below 10.
  161.  
  162.  
  163.                              RUNNING THE PROGRAM
  164.  
  165.          The GROCERY SHOPPER should be run from a hard disk. While it may 
  166.     be run from floppy or hard disk (provided that adequate disk space is 
  167.     available), much of what GROCERY SHOPPER does is disk intensive. 
  168.     Therefore, performance will suffer when attempting to run the GROCERY 
  169.     SHOPPER from a diskette.
  170.  
  171.          There are no fancy installation steps for The Grocery Shopper.
  172.     Simply determine where on your hard disk you want to keep The Grocery
  173.     Shopper (either by selecting an existing or creating a new directory)
  174.     and copy all nine files listed above to that directory. The Grocery
  175.     Shopper will create its' index files (*.ntx) during the initial startup
  176.  
  177.  
  178.  
  179.     of the program.
  180.  
  181.     1. Summary of Operations
  182.          
  183.          The GROCERY SHOPPER has two important operations for the user, 
  184.     creating and printing a shopping list and (2) building and maintaining 
  185.     a database of grocery items . The items database must be developed 
  186.     before the list can be created, however, once the basic database is 
  187.     completed there is little that must be done in future session except 
  188.     add the occasional new item that wasn't purchased before, or modify 
  189.     existing item locations, descriptions, etc. 
  190.  
  191.          When the GROCERY SHOPPER is started, the user is presented with a 
  192.     horizontal MAIN MENU across the top of the screen from which various 
  193.     operations may be chosen. In the right center portion of the screen is 
  194.     the item selection box which is where the various grocery items are 
  195.     displayed and, when activated with the CREATE A LIST command, where 
  196.     the actual list is made up.
  197.  
  198.          GROCERY SHOPPER comes with a database of 144-odd items which, 
  199.     unless you have identical tastes and use the same store as we do, will 
  200.     need some modification.
  201.  
  202.          The EDIT ITEMS command will jump the user to the ITEMS sub-system 
  203.     where all information about grocery items is added and maintained. 
  204.     Here the user can modify the existing items according to the Aisle, 
  205.     Cost Per, Category and Sub Category the user prefers. In addition, the 
  206.     user should enter as many different items as he or she can think of 
  207.     which are normally purchased, in order to have those items available 
  208.     when it come time to make up the actual shopping list.
  209.  
  210.          The GROCERY SHOPPER utilizes the relatively common programming 
  211.     concept of making it feel that the user is going down and coming back 
  212.     up a ladder. Some commands act directly, some take you only one step 
  213.     and some commands when chosen will reveal more commands which are 
  214.     available or which must be utilized. In order to back out of any 
  215.     operation, or move back up to a previous level (consider the initial 
  216.     screen or MAIN MENU the 'top') simply press the <Esc> key.
  217.  
  218.     2. Start Up.
  219.  
  220.          Log onto the directory where The GROCERY SHOPPER files are 
  221.     located. Be certain that all files are present, then simply type 
  222.     'GROCERY' from the DOS prompt. You will be presented with an 
  223.     Introduction screen, the index files will be created then you will be 
  224.     delivered to the GROCERY SHOPPERs' MAIN MENU. The index files will 
  225.     only be created the first time the system is started or any time 
  226.     thereafter when the program can't find it's index files (ie: they've 
  227.     been erased).
  228.  
  229.     3. Navigational Control
  230.  
  231.          The MAIN MENU and the EDIT ITEMS MENU are Lotus-Style Horizontal 
  232.     highlight bar devices. Other menus, such as the one presented when 
  233.     PRINT is selected from the MAIN MENU utilize Vertical highlight bars. 
  234.  
  235.  
  236.  
  237.     Navigation around menus is controlled by use of the arrow, <PgUp> and 
  238.     <PgDn> keys. Each command, or operation on the MAIN MENU and EDIT 
  239.     ITEMS MENU can be selected either by moving the highlight bar to the 
  240.     command and pressing the <Enter> or <Return> key or by pressing the 
  241.     first letter of the command (ie: 'c' or 'C' for Create A List, 'd' or 
  242.     'D' for Delete). Vertical menus require that the highlight bar be 
  243.     placed on the selection and <Enter> pressed.
  244.  
  245.          When using the CREATE A LIST command a highlight bar is activated 
  246.     in the item selection box. Again, navigation is controlled by the 
  247.     arrow, <PgUp> and <PgDn> keys. In addition, to go to the first record 
  248.     press the <Ctrl> and the <PgUp> keys simultaneously. Similarly, to go 
  249.     to the last record, press the <Ctrl> and the <PgDn> keys 
  250.     simultaneously. 
  251.  
  252.          From the EDIT ITEMS MENU, when ADDing or UPDATEing an item 
  253.     navigation keys work identically as described above.
  254.  
  255.          Note that when going to the first or last records, if a FILTER is 
  256.     in effect the first and last records are the first and last in the 
  257.     group being FILTERed. 
  258.  
  259.  
  260.     4. MAIN MENU
  261.  
  262.          When you select CREATE A LIST the highlight bar is activated in 
  263.     the item selection box on screen. Navigate up and down through the 
  264.     items by using the key combinations described above. When you want to 
  265.     place an item on your list, put the highlight bar on the item and 
  266.     press enter. A checkmark will appear under the "Buy" column indicating 
  267.     that the item has been selected for purchase and will appear on the 
  268.     printed list.
  269.  
  270.          Entering an amount (or quantity) is optional except if you're 
  271.     going to utilize the costing report/list. To do so, press the letter 
  272.     'a' or 'A'. A field will appear under the 'Amount' column and the 
  273.     cursor will be activated in this field. Type in the amount and press 
  274.     <Enter>.
  275.  
  276.          To UN-select one item (remove it from the list), move the 
  277.     highlight bar to that item and press the letter 'D' or 'd' (for 
  278.     delete). 
  279.  
  280.          To start a new list 'from scratch', utilize the DELETE command.
  281.  
  282.          A summary of the function of each command/operation and 
  283.     instructions for use is available through on-line help, accessed by 
  284.     pressing the <F1> key. Select the command then press <F1>.
  285.  
  286.     5. EDIT ITEMS Menu
  287.  
  288.          When you select EDIT ITEMS from the MAIN MENU you jump 'down' to 
  289.     a second horizontal bar menu which gives you access to individual 
  290.     items. You can flip through these items by using the navigational keys 
  291.     described above until you find the one you want to work on. <PgDn> and 
  292.  
  293.  
  294.  
  295.     the down arrow move you 'down' item by item. <PgUp> and the up arrow 
  296.     key does the opposite.
  297.  
  298.          A summary of the functions of each command/operation and 
  299.     instructions for use is available through on-line help, accessed by 
  300.     pressing the F1 key.
  301.  
  302.     6. SEARCHing
  303.  
  304.          The SEARCH operation, found on both the MAIN and EDIT ITEMS 
  305.     menus, actually performs two primary functions. The first as you might 
  306.     expect, is to help you find a grocery item by item, aisle, category 
  307.     or sub-category.
  308.  
  309.          When you SEARCH, a Search menu drops down. From this you choose 
  310.     your search 'key', either Aisle, Item, Category or Sub-Category. You 
  311.     then enter the name of the Aisle, Item, etc. for which you want to 
  312.     search and press <Enter>. The program will search for the appropriate 
  313.     piece of information you entered and, if it's found, will display it 
  314.     on screen. If not found, a message will pop-up to that effect. The 
  315.     match between the 'key' and the target (ie: the AISLE or the ITEM) 
  316.     must be exact.
  317.  
  318.          The second purpose is to reset the index to the search 'key' 
  319.     which you have selected. Whether or not the item you're searching for 
  320.     is found the indexes will be reset to that index 'key', again, either 
  321.     Aisle, Item, Category or Sub-Category. So, if you search by ITEM, the 
  322.     database will be reset and will appear in alphabetical order by item. 
  323.     This can be very helpful if, for example you want to view you grocery 
  324.     items in order of category, where all dairy will be grouped together, 
  325.     or all meat grouped together, etc. Try it out.
  326.  
  327.  
  328.                                      HELP
  329.  
  330.          All Clark Systems programs, including the GROCERY SHOPPER, 
  331.     include HELP systems which can be edited and changed by the user. 
  332.     When help is called up by pressing the <F1> key the cursor is active 
  333.     in the HELP screen. Move around the HELP screens using navigation keys 
  334.     discussed above. If you want to make changes, <Ins>, <Del>, 
  335.     <Backspace> and other keys are available for editing, as in any 
  336.     typical word processor. 
  337.  
  338.          On some occasions HELP may not have been included. In this case
  339.     the program will tell you that that portion of the program is Help-
  340.     less and ask if you want to add some. Respond to the prompt 
  341.     accordingly.
  342.  
  343.     NOTE!!! IN ORDER TO SAVE YOUR CHANGES or additions to HELP, you must 
  344.     exit the editing session by pressing the <Ctrl> and 'W' keys 
  345.     simultaneously. Using <Esc> to exit will not save your changes.
  346.  
  347.  
  348.                                    PROBLEMS
  349.  
  350.  
  351.  
  352.  
  353.          In all cases you should periodically back up your files to avoid 
  354.     loss of data due to unexpected problems like electrical outages, 
  355.     spilled coffee, etc. Simply keep a copy of all original files in a 
  356.     safe place and periodically copy all (and only) the .DBF, .DBT, and 
  357.     .TBK files to a separate diskette, either using the DOS copy or xcopy
  358.     commands, or a reasonably good commercial backup program (NOT the DOS
  359.     Backup). If your files do get clobbered first erase all existing 
  360.     GROCERY SHOPPER files, copy all original files to your operating 
  361.     directory or disk, THEN copy the backed up .DBF, .DBT and .TBK files 
  362.     to that directory or disk. This should help you avoid having to re-
  363.     enter a lot of data should a problem arise.
  364.  
  365.          The only other serious problem might result from corruption of 
  366.     the indexes. Symptoms of such corruption are the inability to find 
  367.     grocery items through the SEARCH function, failure of the program to 
  368.     display or print items which you KNOW should be there, Help screens 
  369.     that don't correspond to the appropriate area, etc.
  370.  
  371.          If you suspect such a problem you may correct it easily by 
  372.     (CAREFULLY) erasing all index files, ie: those with the extension 
  373.     .NTX. Do this either individually or with the DOS command 'ERASE 
  374.     *.NTX' (without the quotes). The next time the program starts up it 
  375.     will automatically create the needed index files properly indexed.
  376.  
  377.                                  REGISTRATION     
  378.     _______________________________________________________________________
  379.  
  380.                                    ENJOY!!
  381.  
  382. 
  383.